; > adfs::AvonKbd.ReadMe

This disc contains all you need to make version 0.12 of the Avon keyboard
controller software. The files on this disc are as follows:-

!Kbd                  - Application directory to run to make the image.

    !Run              - Obey file which causes the image to be made.

    AAsm              - The ARM assembler, used just as a macro assembler.

    Hdr               - Directory containing header files.

        Def           - Source file defining symbols involving the
                        communication protocol between the ARM and the
                        keyboard controller.

        Hardware      - Source file defining symbols for (mainly)
                        hardware addresses specific to this application.

        Macros8051    - Source file defining macros which form the 8051
                        cross-assembler.

        SFRs          - Source file defining symbols for hardware addresses
                        applicable to any 8051 application (special function
                        registers).

    Kbd               - Main source file, consisting chiefly of 8051
                        instructions, assembled by means of AAsm macros.

    KbdTran           - Source file containing the translation table from
                        keyboard matrix addresses into key codes to be sent
                        to the ARM.

    MouseTable        - Source file assembled separately, whose object file
                        is 'Obj.MouseTable', which is itself a source file
                        used in the main assembly.

    Obj
        MouseTable    - File created by MouseTable, which is assembled in
                        the main assembly to produce the tables which
                        convert from the mouse quadrature signals into
                        X and Y mouse movements (including hysteresis).

KbdObj                - The final object code.

ReadMe                - This document.

To make the image file, you need a machine running RISC OS 2.00 or later,
with at least 640K of free memory. Open a directory viewer on the disc,
and then double-click on !Kbd. The assembly is in two stages - the first
assembly creates the file 'Obj.MouseTable', which is then used as a source
file by the main assembly, which produces the final image, in '$.KbdObj'.

Any problems, contact Tim Dobson at Newmarket Road (ext 408).
